home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / text / hyper / hsc.readme < prev    next >
Text File  |  1998-10-31  |  11KB  |  249 lines
  1. Short:    V0.917; html-preprocessor (bin+docs)
  2. Author:   Thomas Aglassinger <agi@giga.or.at>
  3. Uploader: Thomas Aglassinger <agi@giga.or.at>
  4. Version:  0.917
  5. Type:     text/hyper
  6. Kurz:     html-Vorarbeiter
  7. Requires: AmigaOS 2.04, 68020, 2MB, UserIQ>50
  8.  
  9. TITLE
  10.  
  11.   hsc - html sucks completely
  12.  
  13. VERSION 
  14.  
  15.   0.917
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <agi@giga.or.at>
  20.  
  21. DESCRIPTION
  22.  
  23.   Hsc is a developer tool for html-projects.
  24.  
  25.   It can be used on any html file and creates a new html file as
  26.   output. In the input file, you may use an extended syntax based on
  27.   html, but which also allows extensions like macros, conditionals and
  28.   more.
  29.  
  30.   It's mainly intended to create and maintain larger html projects. As
  31.   a CLI-only tool, it can be used together with `make', and a
  32.   dependency generator is included.
  33.  
  34.   Hsc is *not* a tool to make html easier for beginners; it's a tool
  35.   to make html a bit less painful and brain-damaged for people who
  36.   already know how to work with it.
  37.  
  38. FEATURES
  39.  
  40.   - macros (implemented as additional tags)
  41.   - conditionals (if/else/elseif)
  42.   - expressions, supporting
  43.     - string concatenation and comparison
  44.     - import of environment variables
  45.     - current time
  46.     - size of files
  47.   - special tags to
  48.     - include files (also verbatim text)
  49.     - execute shell commands (and include output)
  50.     - comment in a reasonable way
  51.   - for local links, checks if file/id exists
  52.   - project relative URIs
  53.   - replaces special characters by entities
  54.   - evaluates attributes for image size (PNG/jfif/gif)
  55.   - can strip useless white space, comments and tags
  56.   - replaces icon entities by images
  57.   - performs a basic syntax- and structure check
  58.   - error messages are easier to understand than the esoteric crap
  59.     tools like sglms vommit
  60.   - maintains a project file
  61.   - includes hscpitt, a tool to examine/manipulate project files
  62.   - includes hscdepp, a dependancy generator for makefiles
  63.  
  64. NEW FEATURES
  65.  
  66.   - added internal support for message browsers for AmigaOS and
  67.     RiscOS
  68.   - as usual some minor bugfixes and improvements
  69.  
  70. SPECIAL REQUIREMENTS
  71.  
  72.   AmigaOS 2.04, 2MB of regular memory, 68020, some sort of w3-browser
  73.   and ASCII editor.
  74.  
  75.   For larger projects, 4MB of memory and 68060 are recommended.
  76.  
  77.   Different to many other html-tools, hsc requires a user-IQ > 50. You
  78.   should also know how to work with the CLI and how to write
  79.   Makefiles. You should already have made some experiences with macro
  80.   processors and some programming language (Rexx should suffice).
  81.  
  82. AVAILABILITY
  83.  
  84.   - Every Aminet-mirror, file "text/hyper/hsc.lha", for example:
  85.  
  86.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc.lha
  87.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-source.lha
  88.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-ps.lha
  89.  
  90.   - http://www.giga.or.at/~agi/hsc/
  91.  
  92. PRICE
  93.  
  94.   Freeware.
  95.  
  96. DISTRIBUTABILITY
  97.  
  98.   Distributed under GNU General Public License.
  99.  
  100. SOURCE CODE
  101.  
  102.   ANSI-C source code is available in a separate archive named
  103.   `hsc-source.lha'.
  104.  
  105.  
  106. ============================= Archive contents =============================
  107.  
  108. Original  Packed Ratio    Date     Time    Name
  109. -------- ------- ----- --------- --------  -------------
  110.       37      37  0.0% 21-Sep-98 10:51:52  FILE_ID.DIZ
  111.      628     276 56.0% 06-Sep-98 15:51:54  hsc.info
  112.    32902   12642 61.5% 21-Sep-98 10:40:14 +CHANGES
  113.      463     241 47.9% 06-Sep-98 15:51:42 +CHANGES.info
  114.    17982    6993 61.1% 26-Jun-95 08:31:52 +COPYING
  115.      463     243 47.5% 06-Sep-98 15:51:42 +COPYING.info
  116.      628     270 57.0% 06-Sep-98 15:51:42 +docs-source.info
  117.      436     262 39.9% 10-Oct-97 02:01:02 +README
  118.      463     238 48.5% 02-Jun-97 04:24:52 +README.info
  119.      628     280 55.4% 06-Sep-98 15:51:42 +docs.info
  120.     5109    2385 53.3% 21-Sep-98 10:35:10 +about.html
  121.     6353    2826 55.5% 21-Sep-98 10:38:36 +author.html
  122.     6647    3064 53.9% 21-Sep-98 10:37:42 +bugs.html
  123.     6304    2823 55.2% 21-Sep-98 10:40:44 +changes.html
  124.     2177    1049 51.8% 21-Sep-98 10:35:22 +copy.html
  125.     4056    1608 60.3% 21-Sep-98 10:35:26 +distrib.html
  126.     2393    1083 54.7% 21-Sep-98 10:36:20 +envvar.html
  127.     2300    1041 54.7% 21-Sep-98 10:35:16 +examples.html
  128.     8454    3148 62.7% 21-Sep-98 10:36:08 +assign.html
  129.     1883     855 54.5% 21-Sep-98 10:36:54 +checkuri.html
  130.     9800    3653 62.7% 21-Sep-98 10:36:02 +exec.html
  131.     7019    2473 64.7% 21-Sep-98 10:37:14 +expressions.html
  132.     6282    2795 55.5% 21-Sep-98 10:35:34 +getsize.html
  133.     4717    1762 62.6% 21-Sep-98 10:35:54 +if.html
  134.     9003    3821 57.5% 21-Sep-98 10:37:20 +prefs.html
  135.     2206    1082 50.9% 21-Sep-98 10:36:42 +rplcent.html
  136.    13155    3759 71.4% 21-Sep-98 10:36:14 +spcattr.html
  137.    13306    4927 62.9% 21-Sep-98 10:37:30 +spctags.html
  138.     3913    1683 56.9% 21-Sep-98 10:35:40 +strip.html
  139.     1894     882 53.4% 21-Sep-98 10:36:06 +syntax.html
  140.     5930    2439 58.8% 21-Sep-98 10:36:44 +uris.html
  141.     5937    2354 60.3% 21-Sep-98 10:36:36 +fileargs.html
  142.     2807    1377 50.9% 21-Sep-98 10:35:20 +future.html
  143.      103     103  0.0% 06-Jun-97 23:32:02 +austria.gif
  144.      138     138  0.0% 14-Jan-96 17:27:46 +back.gif
  145.      190     190  0.0% 14-Jan-96 17:20:08 +copy.gif
  146.      140     140  0.0% 06-Jun-97 23:31:34 +english.gif
  147.      638     638  0.0% 26-May-96 02:10:44 +hsc.gif
  148.      170     170  0.0% 14-Jan-96 17:14:34 +index.gif
  149.      176     176  0.0% 14-Jan-96 17:14:44 +main.gif
  150.      189     189  0.0% 14-Jan-96 17:15:02 +next.gif
  151.      347     347  0.0% 12-Oct-96 18:51:36 +niceguy.gif
  152.      168     168  0.0% 14-Jan-96 17:28:12 +noback.gif
  153.      211     211  0.0% 14-Jan-96 17:20:36 +nocopy.gif
  154.      200     200  0.0% 14-Jan-96 17:15:28 +noindex.gif
  155.      201     201  0.0% 11-Jan-98 16:39:54 +nomain.gif
  156.      212     212  0.0% 14-Jan-96 17:15:52 +nonext.gif
  157.      213     213  0.0% 15-Jul-96 23:44:28 +noprev.gif
  158.      188     188  0.0% 14-Jan-96 17:16:08 +prev.gif
  159.      111     111  0.0% 06-Jun-97 23:32:22 +teutsch.gif
  160.      141     141  0.0% 04-Nov-95 02:20:36 +up.gif
  161.     7398    2709 63.3% 21-Sep-98 10:38:46 +index.html
  162.      462     241 47.8% 04-Sep-98 04:07:48 +index.html.info
  163.     4806    2115 55.9% 21-Sep-98 10:35:50 +install.html
  164.     5048    1837 63.6% 21-Sep-98 10:36:38 +attrib.html
  165.     4698    1710 63.6% 21-Sep-98 10:37:06 +flag.html
  166.     9618    3613 62.4% 21-Sep-98 10:37:00 +macros.html
  167.    23998    7680 67.9% 21-Sep-98 10:36:28 +message-list.html
  168.    12238    4707 61.5% 21-Sep-98 10:37:36 +messages.html
  169.    12943    4911 62.0% 21-Sep-98 10:36:32 +options.html
  170.     6333    2776 56.1% 21-Sep-98 10:35:46 +others.html
  171.     7486    3223 56.9% 21-Sep-98 10:36:18 +ports.html
  172.     3530    1446 59.0% 21-Sep-98 10:35:36 +hscdepp.html
  173.     2321    1066 54.0% 21-Sep-98 10:37:48 +hscpaltrow.html
  174.     7278    2658 63.4% 21-Sep-98 10:35:30 +hscpitt.html
  175.    10713    3922 63.3% 21-Sep-98 10:36:52 +index.html
  176.     6693    2957 55.8% 21-Sep-98 10:35:14 +make.html
  177.     4309    1799 58.2% 21-Sep-98 10:38:12 +makefile.html
  178.     3106    1308 57.8% 21-Sep-98 10:36:48 +prjfile.html
  179.     9133    3629 60.2% 21-Sep-98 10:38:52 +questions.html
  180.     4583    1999 56.3% 21-Sep-98 10:38:02 +related.html
  181.     3692    1735 53.0% 21-Sep-98 10:38:24 +require.html
  182.    11566    4888 57.7% 21-Sep-98 10:35:58 +source.html
  183.     2633    1229 53.3% 21-Sep-98 10:35:42 +teutsch.html
  184.     3670    1672 54.4% 21-Sep-98 10:38:18 +undocumented.html
  185.     3579    1581 55.8% 21-Sep-98 10:38:08 +updates.html
  186.    12652    5259 58.4% 21-Sep-98 10:38:30 +usecases.html
  187.      628     275 56.2% 06-Sep-98 15:51:42 +examples.info
  188.      628     273 56.5% 08-Jun-97 10:44:16 +advanced.info
  189.      249     154 38.1% 23-Aug-98 21:13:12 +README
  190.      463     239 48.3% 03-Jun-97 03:00:22 +README.info
  191.      628     271 56.8% 08-Jun-97 10:44:16 +fetzenschaedl.info
  192.      347     347  0.0% 12-Oct-96 18:51:36 +hugo.gif
  193.      217     172 20.7% 23-Oct-95 02:54:30 +hugo.hsc
  194.     1104     514 53.4% 30-Sep-96 04:55:44 +macro.hsc
  195.      398     257 35.4% 23-Jul-96 14:13:18 +main.hsc
  196.      583     296 49.2% 07-Jan-98 08:37:42 +Makefile
  197.     2497    1168 53.2% 03-Jun-97 03:51:46 +README
  198.      463     238 48.5% 03-Jun-97 03:00:22 +README.info
  199.      178     139 21.9% 16-Sep-95 23:32:32 +stupid.hsc
  200.      628     274 56.3% 08-Jun-97 10:44:16 +simple.info
  201.       55      55  0.0% 09-Mar-97 21:33: